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ABOUT THIS CHAPTER 


This chapter describes the Package Manager, which is the part of the Toolbox 
that provides access to packages. The Macintosh packages include one for 
presenting the standard user interface when a file is to be saved or opened, and 
others for doing more specialized operations such as floating-point arithmetic. 


You should already be familiar with the Resource Manager. 
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ABOUT PACKAGES 


Packages are sets of data types and routines that are stored as resources and 
brought into memory only when needed. They serve as extensions to the Toolbox 
and Operating System, for the most part performing less common operations. 


The Macintosh packages, which are stored in the system resource file, include 
the following: 


« The Standard File Package, for presenting the standard user interface 
when a file is to be saved or opened. 

e The Disk Initialization Package, for initializing and naming new disks. 
This package is called by the Standard File Package; you'll only need 
to call it in nonstandard situations. 

¢ The International Utilities Package, for accessing country-dependent 
information such as the formats for numbers, currency, dates, and times. 

« The Binary-Decimal Conversion Package, for converting integers to 
decimal strings and vice versa. 

¢ The Floating-Point Arithmetic Package, which supports extended-precision 
arithmetic according to IEEE Standard 754. 

¢ The Transcendental Functions Package, which contains trigonometric, 
logarithmic, exponential, and financial functions, as well as a random 
number generator. 

« The List Manager Package, for creating, displaying, and manipulating lists. 


The following Macintosh packages, previously stored only in the system resource 
file, are now also found in the 128K ROM: 


e The Binary-Decimal Conversion Package 
e The Floating-Point Arithmetic Package 
¢ The Transcendental Functions Package 


For compatibility with the 64K ROM, the above resources are still stored in the 
system resource file. The system resource file contains the following additional 
packages as well: 


The List Manager Package, for creating, displaying, and manipulating lists. 
The Standard File Package. 

The Disk Initialization Package 

The International Utilities Package 


e 
e 
e 
e 


Packages have the resource type 'PACK' and the following resource IDs: 


CONST listMgr = 0; {List Manager} 
dskInit = 2; {Disk Initialization} 
stdFile = 3; {Standard File} 
flPoint = 4; {Floating-Point Arithmetic} 
trFunct = 5; {Transcendental Functions} 
intUtil = 6; {International Utilities} 
bdConv =/7; {Binary-Decimal Conversion} 
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The Package Manager has been extended to allow for eight additional packages. 
All packages are reserved for use by Apple. 


Assembly- language note: 


Just as for the routines in ROM, you can invoke a 
package routine with a macro that has the same name 

as the routine preceded by an underscore. These 
macros, however, aren't trap macros themselves; 
instead, they expand to invoke the trap macro PackN, 
where N is the resource ID of the package. The package 
determines which routine to execute from the routine 
selector, an integer that's passed to it in a word on 
the stack. For example, the routine selector for the 
Standard File Package procedure SFPutFile is 1, so 
invoking the macro SFPutFile pushes 1 onto the stack 
and invokes Pack3. The routines in the Floating-Point 
Arithmetic and Transcendental Functions packages also 
invoke a trap macro of the form PackN, but the 
mechanism through which they're called is somewhat 
different, as explained in the chapter describing 
those packages. 
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PACKAGE MANAGER ROUTINES 


There are two Package Manager routines that you can call directly from Pascal: 
one that lets you access a specified package and one that lets you access all 
packages. The latter will already have been called when your application starts 
up, so normally you won't ever have to call the Package Manager yourself. Its 
procedures are described below for advanced programmers who may want to use them 
in unusual situations. 


PROCEDURE InitPack (packID: INTEGER); 


InitPack enables you to use the package specified by packID, which is the 
package's resource ID. (It gets a handle that will be used later to read the 
package into memory.) 


PROCEDURE InitAllPacks; 
InitAllPacks enables you to use all Macintosh packages (as though InitPack were 


called for each one). It will already have been called when your application 
starts up. 
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SUMMARY OF THE PACKAGE MANAGER 


Constants 
CONST 


{ Resource IDs for packages } 


listMgr = 0; {List Manager} 
dskInit = 2; {Disk Initialization} 
stdFile = 3 {Standard File} 
FlPoint = 4; {Floating-Point Arithmetic} 
trFunct = 75: {Transcendental Functions} 
intUtil = 6; {International Utilities} 
bdConv iy {Binary-Decimal Conversion} 
Routines 
PROCEDURE InitPack (packID: INTEGER); 


PROCEDURE InitAllPacks; 


Assembly-Language Information 
Constants 


; Resource IDs for packages 


listMgr .EQU 0 ;List Manager 

dskInit . EQU 2 ;Disk Initialization 
stdFile . EQU 3 sStandard File 

flPoint .EQU 4 ;Floating-Point Arithmetic 
trFunct . EQU 5 sTranscendental Functions 
intUtil . EQU 6 sInternational Utilities 
bdConv . EQU 7 ;Binary-Decimal Conversion 


Trap Macros for Packages 


List Manager _ Pack 

Disk Initialization _Pack2 

Standard File _Pack3 

Floating-Point Arithmetic _Pack4 (synonym: —FP68K) 
Transcendental Functions Pack5 (synonym: —Elems68K) 
International Utilities _Pack6 


Binary-Decimal Conversion —Pack7 
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Further Reference: 


Resource Manager 

List Manager Package 
Disk Initialization Pkg 
Standard File Package 
Floating-Point & Trans 
International Utilities 
Binary-Decimal Conv Pkg 


END OF DOCUMENT 
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